pp108 : Example for addComments property

Example for addComments property

Consider the following WSDL:

<wsdl:definitions name="GetEmployeesObjects"
    targetNamespace="http://schemas.cordys.com/Employees"
    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
    xmlns:tns="http://schemas.cordys.com/Employees" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
    <wsdl:types>
        <xsd:schema attributeFormDefault="unqualified"
            elementFormDefault="qualified"
            targetNamespace="http://schemas.cordys.com/Employees"
            xmlns:tns="http://schemas.cordys.com/Employees" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
            <xsd:element name="GetEmployeesObjects">
                <xsd:complexType>
                    <xsd:sequence>
                        <xsd:element maxOccurs="2" minOccurs="1" name="fromEmployeeID">
                            <xsd:simpleType>
                                <xsd:restriction base="xsd:int">
                                    <xsd:totalDigits value="10"/>
                                </xsd:restriction>
                            </xsd:simpleType>
                        </xsd:element>
                        <xsd:element maxOccurs="unbounded" minOccurs="1" name="toEmployeeID">
                            <xsd:simpleType>
                                <xsd:restriction base="xsd:int">
                                    <xsd:totalDigits value="10"/>
                                </xsd:restriction>
                            </xsd:simpleType>
                        </xsd:element>
                    </xsd:sequence>
                </xsd:complexType>
            </xsd:element>
            <xsd:element name="GetEmployeesObjectsResponse" type="xsd:string"/>
        </xsd:schema>
    </wsdl:types>
    <wsdl:message name="GetEmployeesObjectsInput">
        <wsdl:part element="tns:GetEmployeesObjects" name="body"/>
    </wsdl:message>
    <wsdl:message name="GetEmployeesObjectsOutput">
        <wsdl:part element="tns:GetEmployeesObjectsResponse" name="body"/>
    </wsdl:message>
    <wsdl:portType name="MethodSetEmployeesPortType">
        <wsdl:operation name="GetEmployeesObjects">
            <wsdl:input message="tns:GetEmployeesObjectsInput"/>
            <wsdl:output message="tns:GetEmployeesObjectsOutput"/>
        </wsdl:operation>
    </wsdl:portType>
    <wsdl:binding name="MethodSetEmployeesBinding" type="tns:MethodSetEmployeesPortType">
        <soap:binding style="document"
            transport="http://schemas.xmlsoap.org/soap/http" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"/>
        <wsdl:operation name="GetEmployeesObjects">
            <soap:operation soapAction=""/>
            <wsdl:input>
                <soap:body use="literal"/>
            </wsdl:input>
            <wsdl:output>
                <soap:body use="literal"/>
            </wsdl:output>
        </wsdl:operation>
    </wsdl:binding>
    <wsdl:service name="MethodSetEmployeesService">
        <wsdl:port binding="tns:MethodSetEmployeesBinding" name="MethodSetEmployeesPort">
            <soap:address location="http://localhost/cordys/com.eibus.web.soap.Gateway.wcp?organization=o=system,cn=cordys,o=vanenburg.com"/>
        </wsdl:port>
    </wsdl:service>
</wsdl:definitions>

addComments property set to 'false'


If the addComments property is set to 'false' in WSDL Manager
On GetEmployeesObjects bindingOperation if we use getInputSOAPInstance Web service operation the SOAP instance is as shown below:

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <GetEmployeesObjects xmlns="http://schemas.cordys.com/Employees">
            <fromEmployeeID>PARAMETER</fromEmployeeID>
            <toEmployeeID>PARAMETER</toEmployeeID>
        </GetEmployeesObjects>
    </SOAP:Body>
</SOAP:Envelope>

addComments property set to 'true'


If the addComments property is set to 'true' in WSDL Manager
On GetEmployeesObjects bindingOperation if we use getInputSOAPInstance Web service operation the SOAP instance is as shown below :

<SOAP:Envelope xmlns:SOAP="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP:Body>
        <GetEmployeesObjects xmlns="http://schemas.cordys.com/Employees">
            <!-- 1 to 2 repetitions: -->
            <fromEmployeeID>PARAMETER</fromEmployeeID>
            <!-- 1 or more repetitions: -->
            <toEmployeeID>PARAMETER</toEmployeeID>
        </GetEmployeesObjects>
    </SOAP:Body>
</SOAP:Envelope>